package com.vegetable.modules.service.stock;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.vegetable.modules.entity.stock.Stock;
import com.vegetable.modules.entity.stock.to.PriceElementChangeQueryTO;
import com.vegetable.modules.entity.stock.to.PriceElementDetailQueryTO;
import com.vegetable.modules.entity.stock.to.PriceTrendQueryTO;
import com.vegetable.modules.vo.PriceElementChangeVO;
import com.vegetable.modules.vo.PriceElementDetailVO;
import com.vegetable.modules.vo.PriceTrendVO;

import java.util.List;

/**
 * <p>
 * 价格要素变动服务类
 * </p>
 *
 * @author Qwen
 * @since 2025-09-27
 */
public interface IPriceElementChangeService extends IService<Stock> {

    /**
     * 分页查询价格要素变动记录
     * @param queryTO 查询条件
     * @return 分页结果
     */
    IPage<PriceElementChangeVO> queryPriceElementChanges(PriceElementChangeQueryTO queryTO);

    
    /**
     * 查询价格要素详细记录列表
     * @param queryTO 查询条件
     * @return 价格要素详细记录列表
     */
    List<PriceElementDetailVO> listPriceElementDetails(PriceElementDetailQueryTO queryTO);
    
    /**
     * 查询价格趋势
     * @param queryTO 查询条件
     * @return 价格趋势列表
     */
    List<PriceTrendVO> listPriceTrend(PriceTrendQueryTO queryTO);
    
    /**
     * 获取入库类型描述
     * @param storageType 入库类型
     * @return 入库类型描述
     */
    String getStorageTypeDescription(Integer storageType);
}